Reembolsar tender - Fire spark

Reembolsa un tender PAID que todavía tiene dinero pendiente. Omite amount e items para un reembolso completo. Envía amount o items, no ambos. La llamada es idempotente por idempotency_key.

Requiere un access token de Storefront API de Intercambio de token. El pedido ya debe estar colocado.

En @fire-spark/storefront, llama order.refundTender(tenderId, { amount, reason }).

Parámetros de ruta

Parámetro	Requerido	Descripción
`id`	Sí	Identificador externo del pedido
`tenderId`	Sí	Identificador del tender

Cuerpo de la solicitud

Campo	Requerido	Descripción
`idempotency_key`	Sí	10–64 caracteres
`amount`	No	Reembolso parcial, mayor que 0
`items`	No	`[{ line_uid, units? }]`. No lo envíes junto con `amount`.
`reason`	No	Hasta 500 caracteres

curl -X POST "https://firespark.cloud/api/storefront/v1/orders/ord-48291/tenders/tnd-card-1/refund" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "idempotency_key": "refund-9f3c1a20b4", "amount": 4.5 }'

Respuesta

Devuelve 200 con el pedido. refunded_total del tender sube por el monto reembolsado. Un reembolso completo deja el tender en REFUNDED. Un resultado NEEDS_REVIEW igual aplica el reembolso y deja el caso para revisión. Un rechazo devuelve 502 y no cambia el tender.

Respuestas de error

Estado	Descripción
`404`	Pedido o tender no encontrado
`409`	El pedido sigue `OPEN`, o el tender no está pagado con dinero pendiente
`422`	Se enviaron `amount` e `items` a la vez
`502`	El proveedor rechazó el reembolso